home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / gfx / ycur2iff.lha / ycur2iff / README next >
Text File  |  1995-09-04  |  4KB  |  121 lines
  1.  
  2.                 YCur2IFF -- .CUR (WinNT) to IFF converter
  3.                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.                 (C) 1995 Yoda
  5.  
  6.  
  7. 1. Introduction
  8. ---------------
  9.  
  10.         This program converts cursor bitmaps from Windows NT (control
  11. panel) to IFF brushes. It supports both '.CUR' and '.ANI' (animation)
  12. formats. The resultant IFF brushes are saved one per frame. These
  13. files can be joined in an IFF animation using an appropriate program,
  14. as Deluxe Paint.
  15.  
  16.  
  17. 2. System Requirements and Installation
  18. ---------------------------------------
  19.  
  20.         YCur2IFF runs under Kickstart 2.04 and uses iffparse.library.
  21. The program is just the executable binary, so no further installation
  22. procedures are required other than copying the file ycur2iff to the
  23. desired location.
  24.  
  25.  
  26. 3. Usage
  27. --------
  28.  
  29.         Ycur2iff is a CLI program that takes as argument the filename
  30. of the file to convert, eg.
  31.  
  32.                 ycur2iff HORSE.ANI
  33.  
  34. After processing the file, ycur2iff saves a number of files, twice as
  35. the number of frames. Each frame contains one 'body' and one 'mask'.
  36. The 'body' contains the cursor itself with each pixel with a specified
  37. color. The 'mask' specifies the shape of the cursor frame by
  38. indicating which pixels constitutes the cursor. Each frame's 'body'
  39. and 'mask' are saved in separate files. Using the example above, the
  40. following files (IFF brushes) are produced :
  41.  
  42.                 HORSE.fr000.body.iff
  43.                 HORSE.fr000.mask.iff
  44.                 HORSE.fr001.body.iff
  45.                 HORSE.fr001.mask.iff
  46.                 HORSE.fr002.body.iff
  47.                 HORSE.fr002.mask.iff
  48.                 ...
  49.  
  50. For single framed cursors (.CUR extension), only two files are saved,
  51. eg.
  52.  
  53.                 ycur2iff 3DGARRO.CUR
  54.  
  55. produce the files :
  56.  
  57.                 3DGARRO.body.iff
  58.                 3DGARRO.mask.iff
  59.  
  60.  
  61. 4. Technical details
  62. --------------------
  63.  
  64.         From each frame there are three chunks of data that are used :
  65. (i) palette, (ii) body and (iii) mask. The palette is converted in the
  66. CMAP IFF chunk in the .body.iff file with the body of the cursor. The
  67. cursor body is chunky, so that it is required to convert it to planar,
  68. in the BODY chunk. The mask is monochrome, so that the chunky equals
  69. the planar format. The IFF files are built using the iffparse.library
  70. routines. For speed, the entire input file is loaded to a buffer in
  71. memory.
  72.  
  73.  
  74. 5. Limitations, Bugs and Features
  75. ---------------------------------
  76.  
  77.         By now, this program is hard-coded to handle 32x32 by 16
  78. colors cursors. YCur2iff was originally coded to decode a certain
  79. animation for use in SleepingPointers package (from aminet). As you
  80. can see by the  source, the program is rather simple. If
  81. enough feedback is received, I can improve it, in order to be more
  82. sensitive. The source format is not parsed at all.
  83.  
  84.  
  85. 6. Greetings
  86. ------------
  87.  
  88.         Greetings go for the great friends :
  89.                 Psys (programmer, author of SleepingPointers)
  90.                 HotShot (musician, author of several aminet mods)
  91.                 and IST CIIST dudes in general ...
  92.  
  93.  
  94. 7. Author
  95. ---------
  96.  
  97.         You can contact me by the email :
  98.  
  99.                 l36612@alfa.ist.utl.pt
  100.  
  101. or by snailmail :
  102.  
  103.                 Rodrigo Ventura
  104.                 R. José Leilote, 26
  105.                 1900 Lisboa
  106.                 Portugal
  107.  
  108.  
  109.  
  110.  
  111.     +--------------------------------------------------------+-----------+
  112.     |         Rodrigo Ventura, alias <Master Yoda>           |     /     |
  113.     +--------------------------------------------------------+  - / ---  |
  114.     |  Electronic Engineering Course, Control and Robotics   |  | |  |   |
  115.     |     Instituto Superior Tecnico, Lisboa, Portugal       |  | |  |   |
  116.     +--------------------------------------------------------+  - /  |   |
  117.     | L36612@alfa.ist.utl.pt      rmmv@camoes.rnl.ist.utl.pt |   /       |
  118.     +--------------------------------------------------------+-----------+
  119.  
  120. PS: Please apologize my poor English, it is not my native language ... 8-)
  121.